home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_xemacs.idb / usr / freeware / lib / xemacs-20.4 / info / tm-vm-en.info.z / tm-vm-en.info
Encoding:
GNU Info File  |  1998-05-21  |  14.5 KB  |  456 lines
  1. This is Info file ../../info/tm-vm-en.info, produced by Makeinfo
  2. version 1.68 from the input file tm-vm-en.texi.
  3.  
  4.    This file documents tm-vm.el v8.12
  5.  
  6.    tm-vm is part of the TM Package.
  7.  
  8.    tm-vm is an interface between tm and the VM mail user agent that lets
  9. you read and write multimedia mail on the Internet using the MIME
  10. standard.
  11.  
  12.    tm-vm and its documentation are distributed under the same terms as
  13. TM. Please refer to the TM Manual.
  14.  
  15.    Copyright 1996 Tomohiko Morioka, Oscar Figueiredo
  16.  
  17. 
  18. File: tm-vm-en.info,  Node: Top,  Next: Overview,  Prev: (dir),  Up: (dir)
  19.  
  20. tm-vm Manual
  21. ************
  22.  
  23.    tm-vm is an interface between tm and the VM mail user agent that lets
  24. you read and write multimedia mail on the Internet using the MIME
  25. standard.
  26.  
  27.    This document applies to release 8.12 of tm-vm.el
  28.  
  29. * Menu:
  30.  
  31. * Overview::
  32. * Install::
  33. * Usage::
  34. * Customization::
  35. * News::
  36. * Copyright::
  37. * Variable Index::
  38. * Concept Index::
  39.  
  40. 
  41. File: tm-vm-en.info,  Node: Overview,  Next: Install,  Prev: Top,  Up: Top
  42.  
  43. Overview
  44. ********
  45.  
  46.    tm-vm is an interface between TM (*note TM: (tm-en)Top..) and the VM
  47. mail user agent (*note VM: (vm)Top..).
  48.  
  49.    Until recently VM did not support the MIME standard. Kyle Jones has
  50. begun to implement it in VM 6.0 however TM provides a much more complete
  51. support of MIME than the one currently offered in VM 6. tm-vm integrates
  52. the TM package into VM so as to give you a powerful MIME support in your
  53. usual mail environment for both mail reading and composing. tm-vm adds
  54. MIME features to VM 5 and replaces the native features offered by VM 6.
  55.  
  56. Mail Reading Features
  57. =====================
  58.  
  59.    tm-vm tries to integrate as transparently as possible with VM so that
  60. MIME messages appear to you just like plain messages.
  61.  
  62.    tm-vm detects MIME messages when you try to view them and, if
  63. automatic MIME previewing is enabled (the default), then it
  64. automatically parses the message and displays a "beautified" version
  65. under the MIME Viewer.  Note that the word *previewing* has two
  66. different meanings for VM and TM. In VM, it means view the first lines
  67. of a message only, as defined by the variable `vm-preview-lines', to
  68. avoid confusion we call this *message previewing*. In TM, previewing
  69. means parsing the contents of a message according to the rules of the
  70. MIME standard and display a corresponding view of it. We call that more
  71. specifically *MIME previewing*.
  72.  
  73.    The MIME Viewer offers all the functionality to view/extract the MIME
  74. components (attachments) of the message. It also displays images inline
  75. in XEmacs. *Note MIME Viewer: (tm-view-en)Top. Note however that for a
  76. better VM integration, tm-vm overrides the standard bindings of the
  77. MIME-Viewer and makes them available with a <C-c> prefix.
  78.  
  79. Mail Composing Features
  80. =======================
  81.  
  82.    Composing a new message places you in a compose buffer as usual
  83. under VM but a special minor mode (`mime-editor') is made available that
  84. lets you perform such operations as:
  85.  
  86.    * Insert arbitrary files
  87.  
  88.    * Insert another message
  89.  
  90.    * Insert a voice sample recorded from a microphone attached to the
  91.      computer
  92.  
  93.    * Enclose message sections as PGP encrypted
  94.  
  95.    and much more. For details, *note MIME Editor: (tm-edit-en)Top..
  96.  
  97.    When you reply to a message citing the original and tm-vm is active,
  98. tm-vm will insert the contents of the MIME-Preview buffer in the reply
  99. buffer. You can also insert the raw message if you want (*note
  100. Usage::.).
  101.  
  102. 
  103. File: tm-vm-en.info,  Node: Install,  Next: Usage,  Prev: Overview,  Up: Top
  104.  
  105. Installing tm-vm
  106. ****************
  107.  
  108.    To take advantage of the benefits of tm-vm, you need to have VM and
  109. tm already installed.
  110.  
  111.    VM is part of XEmacs distributions and so if you're running XEmacs
  112. you don't need to install it.  If you're running Emacs, you will need to
  113. install VM. The official VM distribution site is
  114. `ftp://ftp.uu.net/networking/mail/vm/'.
  115.  
  116.    If you're reading this manual then there is a pretty good chance you
  117. already have a recent version of tm. The official tm distribution site
  118. is `ftp://ftp.jaist.ac.jp/pub/GNU/mime/'. Follow the installation
  119. procedure for tm as described in the documentation.
  120.  
  121.    Once these steps are completed, tm-vm installation is very simple.
  122. You just need to insert the following lines in your VM configuration
  123. file (generally `.vm'):
  124.  
  125.      (require 'mime-setup)
  126.      (require 'tm-vm)
  127.  
  128.    That's it. You are ready to read and send multimedia mail! You may
  129. also want to customize some aspects of tm-vm behaviour (*note
  130. Customization::.).
  131.  
  132.    If you use BBDB, you must load tm-vm *after* BBDB. Please be sure to
  133. respect the following sequence in your initialization file:
  134.  
  135.      (bbdb-insinuate-vm)
  136.      (require 'tm-vm)
  137.  
  138. 
  139. File: tm-vm-en.info,  Node: Usage,  Next: Customization,  Prev: Install,  Up: Top
  140.  
  141. Using tm-vm
  142. ***********
  143.  
  144. * Menu:
  145.  
  146. * Reading MIME mail::           Commands for MIME previewing
  147. * Composing MIME mail::         Writing/Replying to/Forwarding MIME messages
  148. * Printing::                    Printing MIME messages
  149. * Using BBDB::                  BBDB integration
  150.  
  151. 
  152. File: tm-vm-en.info,  Node: Reading MIME mail,  Next: Composing MIME mail,  Prev: Usage,  Up: Usage
  153.  
  154. Reading MIME mail
  155. =================
  156.  
  157.    When reading mail, tm-vm can operate in two different modes:
  158. *automatic preview* and *on-demand preview*. In automatic preview mode
  159. (the default) MIME messages are automatically decoded. In on-demand
  160. preview mode all messages are presented by VM as they are (as if tm
  161. were not loaded). The user can request the decoding of a message at any
  162. time with `tm-vm/view-message' (bound to `Z').
  163.  
  164. VM folder buffer and MIME Preview buffer
  165. ----------------------------------------
  166.  
  167.    Though tm-vm tries to hide this fact as much as possible, it is
  168. important to note that when MIME previewing is enabled the current
  169. message actually exists in *two* separate buffers:
  170.  
  171.    * *the VM folder buffer*: always displays the *raw* message buffer
  172.      where the MIME contents remain unparsed
  173.  
  174.    * *the MIME Preview buffer*: displays a MIME parsed version of the
  175.      message. It is generally what you want to see as it is more
  176.      readable.
  177.  
  178.    There are two different buffers due to the VM 5 implementation that
  179. makes TM/VM integration difficult. However, we try hard to make the MIME
  180. Preview buffer act as if it were the real VM message buffer by making
  181. all bindings act the same in the Preview buffer as in the folder
  182. buffer. In this version of tm-vm, most of the usual VM bindings are made
  183. available transparently in the MIME Preview buffer, others will be in
  184. the future, contact the maintainer for more information.
  185.  
  186.    `tm-vm/toggle-preview-mode' (bound to `M-t') lets you toggle between
  187. automatic and on-demand preview modes.
  188.  
  189. 
  190. File: tm-vm-en.info,  Node: Composing MIME mail,  Next: Printing,  Prev: Reading MIME mail,  Up: Usage
  191.  
  192. Composing MIME mail
  193. ===================
  194.  
  195.    Regardless of the current MIME preview mode (automatic or on-demand),
  196. tm-vm activates the mime-editor mode each time you compose a mail
  197. message (new message, reply or forward).  *Note MIME Editor:
  198. (tm-edit-en)Top, for details on mime-editor mode.
  199.  
  200.    When you reply to a message, tm-vm will insert the contents of the
  201. *decoded* message if there exists a MIME Preview buffer. This is
  202. generally what you want for quoted-printable text, for instance. Inline
  203. images are removed from the reply. If for some reason you want the
  204. *raw* message to be inserted instead of the decoded one, you have to
  205. kill the MIME Preview buffer first. You do this with `kill-buffer'
  206. (bound to `C-x k') in the MIME Preview buffer. You can also toggle
  207. automatic preview off, if it was on, with `M-t'.
  208.  
  209.    Forwarding a message always inserts the raw message with its own MIME
  210. headers. The recipient will thus receive exactly the same message as you
  211. did.
  212.  
  213. 
  214. File: tm-vm-en.info,  Node: Printing,  Next: Using BBDB,  Prev: Composing MIME mail,  Up: Usage
  215.  
  216. Printing MIME messages
  217. ======================
  218.  
  219.    For non-MULE Emacses, printing of MIME messages uses Postscript
  220. printing (through the ps-print package). Non-MIME messages are printed
  221. the usual way as configured in VM. This is controlled by the variable
  222. `tm-vm/use-ps-print'.
  223.  
  224. 
  225. File: tm-vm-en.info,  Node: Using BBDB,  Prev: Printing,  Up: Usage
  226.  
  227. Notes about BBDB Usage
  228. ======================
  229.  
  230.    BBDB, the Big Brother's Database, should operate normally with
  231. VM/tm-vm. You must ensure, however, that tm-vm is loaded *after* BBDB
  232. has installed its hooks. Therefore be sure to respect the following
  233. sequence in your initialization file:
  234.  
  235.      (bbdb-insinuate-vm)
  236.      (require 'tm-vm)
  237.  
  238. 
  239. File: tm-vm-en.info,  Node: Customization,  Next: News,  Prev: Usage,  Up: Top
  240.  
  241. Customization
  242. *************
  243.  
  244.    Several variables let you adapt the behavior of tm-vm to your needs.
  245. You can set these variables to the appropriate value in your
  246. initialization file prior to loading tm.
  247.  
  248.  - User Option: tm-vm/automatic-mime-preview
  249.      If non-`nil' then tm-vm will start in automatic mime preview mode
  250.      (*note Usage::.). Default `t'.
  251.  
  252.  - User Option: tm-vm/strict-mime
  253.      If non-`nil' tm-vm will automatically decode MIME messages only.
  254.      MIME messages have a `MIME-Version' header. If `nil' then all
  255.      messages will be decoded and viewed in the MIME Preview buffer
  256.      regardless of the existence of a `MIME-Version' header. Default
  257.      `t'.
  258.  
  259.  - User Option: tm-vm/use-vm-bindings
  260.      If non-`nil' tm-vm will use usual VM bindings in MIME-Preview
  261.      buffers and make TM bindings available with a prefix. Otherwise
  262.      usual TM bindings are used without prefix (this was the default in
  263.      versions of tm-vm older than 8.0). Default `t'.
  264.  
  265.  - User Option: tm-vm/attach-to-popup-menus
  266.      If this is non-`nil', tm-vm will append a menu of MIME commands to
  267.      the VM standard mode popup (<Button 3>). Default `t'. Untested in
  268.      Emacs.
  269.  
  270.  - User Option: tm-vm/use-original-url-button
  271.      If this is non-`nil', tm-vm will use VM to energize URL's contained
  272.      in the message body as weel as message headers. Default `t'.
  273.  
  274.  - User Option: tm-vm/use-ps-print
  275.      If this is non-`nil' then MIME messages will be printed in
  276.      Postscript using the ps-print package. By default it is `t' for
  277.      non-MULE Emacses.
  278.  
  279.  - Variable: tm-vm/build-mime-preview-buffer-hook
  280.      tm-vm runs the hooks in this list each time it builds a
  281.      MIME-Preview buffer for a message. You can attach your own hook
  282.      functions using `add-hook'.
  283.  
  284.  - Variable: tm-vm/select-message-hook
  285.      tm-vm runs the hooks in this list after selecting a message. You
  286.      can attach your own hook functions using `add-hook'.
  287.  
  288.  - Variable: tm-vm/forward-message-hook
  289.      tm-vm runs the hooks in this list after a Mail mode buffer has been
  290.      created to forward a message in message/rfc822 type format.  If
  291.      `vm-forwarding-digest-type' is `rfc1521', tm-vm runs this hook
  292.      instead of `vm-forward-message-hook'.
  293.  
  294.  - Variable: tm-vm/send-digest-hook
  295.      tm-vm runs the hooks in this list after a Mail mode buffer has been
  296.      created to send a digest in multipart/digest type format.  If
  297.      `vm-digest-send-type' is `rfc1521', tm-vm runs this hook instead
  298.      of `vm-send-digest-hook'.
  299.  
  300. X-Faces
  301. =======
  302.  
  303.    tm-vm displays X-Faces inline for XEmacs users in the same way as
  304. VM. X-Faces are turned on by default. You need to disable their display
  305. explicitly if you want to:
  306.  
  307.      (setq vm-use-lucid-highlighting nil)
  308.      (setq vm-display-xfaces nil)
  309.  
  310. 
  311. File: tm-vm-en.info,  Node: News,  Next: Copyright,  Prev: Customization,  Up: Top
  312.  
  313. News
  314. ****
  315.  
  316.    This section documents the user-visible changes in the latest
  317. releases of tm-vm. For more technical details see the ChangeLog.
  318.  
  319. 8.5 to 8.12
  320. ===========
  321.  
  322.    * Bug fixes
  323.  
  324.    * Compatible with successive VM 6 versions (tested up to VM 6.24).
  325.  
  326.    * Improved overall VM integration.
  327.  
  328.    * New hook variable `tm-vm/build-mime-preview-buffer-hook'.
  329.  
  330. 8.4
  331. ===
  332.  
  333.    * Bug fixes in Emacs menus.
  334.  
  335. 8.0 to 8.3
  336. ==========
  337.  
  338.    * Most usual VM bindings are available in MIME-Preview buffers
  339.      (motion commands, summary generation). Usual TM bindings are
  340.      prefixed with <C-c> now. See the variable `tm-vm/use-vm-bindings'.
  341.  
  342.    * VM menu bar and toolbar are accessible from MIME-Preview buffers
  343.  
  344.    * MIME-Preview buffers support header toggling
  345.  
  346.    * VM message previewing is correctly supported
  347.  
  348.    * Bug fixes
  349.  
  350. 7.79
  351. ====
  352.  
  353.    * Minor bug fixes.
  354.  
  355. 7.78
  356. ====
  357.  
  358.    * Better compatibility with MULE in respect of the ps-print package
  359.  
  360. 7.77
  361. ====
  362.  
  363.    * A bug in byte-compilation introduced in 7.76 was fixed
  364.  
  365.    * Window configurations are restored more correctly (point stays
  366.      where it should :-) when paging through messages.
  367.  
  368. 7.76
  369. ====
  370.  
  371.    * Forwarding a MIME message now always forwards the *raw* message.
  372.  
  373.    * Forwarding a message from the `Dispose' pull-down menu now works
  374.      correctly in XEmacs. Untested in Emacs.
  375.  
  376.    * Forwarding a message when the current buffer is the MIME-Preview
  377.      buffer now works correctly
  378.  
  379.    * `tm-vm/use-ps-print' was introduced *note Customization::..
  380.  
  381. 7.75
  382. ====
  383.  
  384.    * Bug fixes: BBDB record creation and MIME component extraction from
  385.      new messages
  386.  
  387. 7.74
  388. ====
  389.  
  390.    * X-Faces are displayed by default. *note Customization::.
  391.  
  392. 
  393. File: tm-vm-en.info,  Node: Copyright,  Next: Variable Index,  Prev: News,  Up: Top
  394.  
  395. Copyright
  396. *********
  397.  
  398.    This file documents tm-vm 8.12, an interface between tm and the VM
  399. mail user agent.
  400.  
  401.    Copyright 1996 Tomohiko Morioka, Oscar Figueiredo
  402.  
  403.    tm-vm is part of the TM package. tm-vm and its documentation are
  404. distributed under the same terms as TM itself *Note Copyright:
  405. (TM)Copyright.
  406.  
  407. 
  408. File: tm-vm-en.info,  Node: Variable Index,  Next: Concept Index,  Prev: Copyright,  Up: Top
  409.  
  410. Variable Index
  411. **************
  412.  
  413. * Menu:
  414.  
  415. * tm-vm/attach-to-popup-menus:           Customization.
  416. * tm-vm/automatic-mime-preview:          Customization.
  417. * tm-vm/build-mime-preview-buffer-hook:  Customization.
  418. * tm-vm/forward-message-hook:            Customization.
  419. * tm-vm/select-message-hook:             Customization.
  420. * tm-vm/send-digest-hook:                Customization.
  421. * tm-vm/strict-mime:                     Customization.
  422. * tm-vm/use-original-url-button:         Customization.
  423. * tm-vm/use-ps-print:                    Customization.
  424. * tm-vm/use-vm-bindings:                 Customization.
  425.  
  426. 
  427. File: tm-vm-en.info,  Node: Concept Index,  Prev: Variable Index,  Up: Top
  428.  
  429. Concept Index
  430. *************
  431.  
  432. * Menu:
  433.  
  434. * MIME Preview buffer:                   Reading MIME mail.
  435. * VM folder buffer:                      Reading MIME mail.
  436. * X-Faces:                               Customization.
  437.  
  438.  
  439. 
  440. Tag Table:
  441. Node: Top501
  442. Node: Overview933
  443. Node: Install3439
  444. Node: Usage4690
  445. Node: Reading MIME mail5052
  446. Node: Composing MIME mail6711
  447. Node: Printing7788
  448. Node: Using BBDB8165
  449. Node: Customization8574
  450. Node: News11427
  451. Node: Copyright13184
  452. Node: Variable Index13581
  453. Node: Concept Index14278
  454. 
  455. End Tag Table
  456.